package cn.iocoder.yudao.module.wecom.service.acqlink;

import java.util.*;
import javax.validation.*;
import cn.iocoder.yudao.module.wecom.controller.admin.acqlink.vo.*;
import cn.iocoder.yudao.module.wecom.dal.dataobject.acqlink.AcqLinkDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;

/**
 * 获客链接 Service 接口
 *
 * @author 数创万维
 */
public interface AcqLinkService {

    /**
     * 创建获客链接
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createAcqLink(@Valid AcqLinkSaveReqVO createReqVO);

    /**
     * 更新获客链接
     *
     * @param updateReqVO 更新信息
     */
    void updateAcqLink(@Valid AcqLinkSaveReqVO updateReqVO);

    /**
     * 删除获客链接
     *
     * @param id 编号
     */
    void deleteAcqLink(Long id);

    /**
     * 获得获客链接
     *
     * @param id 编号
     * @return 获客链接
     */
    AcqLinkDO getAcqLink(Long id);

    /**
     * 获得获客链接分页
     *
     * @param pageReqVO 分页查询
     * @return 获客链接分页
     */
    PageResult<AcqLinkDO> getAcqLinkPage(AcqLinkPageReqVO pageReqVO);

    /**
     * 同步企微获客链接
     * @since 2024-08-06
     * @author PetePower
     * @return
     */
    Boolean syncAcqLink();

    /**
     * 获取通过指定获客链接加入的客户
     * @since 2024-08-06
     * @author PetePower
     * @return
     */
    void getAcqLinkCustomer();

    /**
     * 查询获客链接的使用情况
     * @param reqVO
     * @since 2024-08-07
     * @author PetePower
     * @return
     */
    Map<String, AcqLinkUseRespVO> getAcqLinkUseStat(AcqLinkUseReqVO reqVO);

    /**
     * 根据linkId 数组获取获客链接集合
     * @param ids
     * @since 2024-08-07
     * @author PetePower
     * @return
     */
    List<AcqLinkDO> getAcqListByLinkIdList(List<String> ids);
}